home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / jvas110.zip / JVARCSRV.DOC < prev    next >
Text File  |  1993-07-27  |  24KB  |  593 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                    JVArcServ V1.10
  10.                                    by John A. Vink
  11.                      (c) 1992, 1993 Gidget Software Development.
  12.  
  13.                                     July 22, 1993
  14.  
  15.  
  16.  
  17.           Disclaimer
  18.           ----------
  19.  
  20.           Neither  I, John A. Vink, nor Gidget Software Development, may be
  21.           held liable for any  damage that running this software  may cause
  22.           to your system.  
  23.  
  24.           Introduction
  25.           ------------
  26.  
  27.           JVArcServ  is based  on the InterNet  utility Archie  designed at
  28.           McGill University  in Quebec,  Canada.   Archie  allows users  to
  29.           locate programs available via anonymous FTP from sites around the
  30.           world.  Since there  are thousands of anonymous FTP  sites around
  31.           the  world, each one holding several  gigabytes of software, this
  32.           utility was a great sigh  of relief.  There are now  eight Archie
  33.           servers in operation today.
  34.  
  35.           JVArcServ does much the same thing for FidoNet as Archie does for
  36.           the InterNet.   It will locate files  that are available for file
  37.           request from other FidoNet or compatible network nodes.
  38.  
  39.           Installation
  40.           ------------
  41.  
  42.           Installation is relatively simple.  A directory has to be created
  43.           to  hold  all  of  the  file  lists  from  other  systems  and  a
  44.           configuration file has to be set up.
  45.  
  46.           Configuration
  47.           -------------
  48.  
  49.           The  default configuration  file is  named 'jvarcsrv.cfg'  in the
  50.           current directory.   You can  change this with  the '-c'  command
  51.           line parameter.  You can do something like:
  52.  
  53.                     JVARCSRV -ce:\files\jvas.cfg
  54.  
  55.           This would use the  file 'jvas.cfg' as the configuration  file in
  56.           the directory 'e:\files'.
  57.  
  58.           The   following  are  the  commands  that  you  can  use  in  the
  59.           configuration  file.  Do  not include a  '\' on the  end of paths
  60.           unless you are referring to a root directory.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.           NODE <node>
  69.                This is  where you put your network address.  <node> must be
  70.                in the standard zzz:nnnn/dddd  format where zzz represents a
  71.                zone  number,  nnnn  represents   a  net  number,  and  dddd
  72.                represents  the node number.  This line must appear once and
  73.                only once somewhere in the configuration file.
  74.  
  75.                Example:
  76.  
  77.                     NODE  1:250/318
  78.  
  79.  
  80.           AKA <node>
  81.                This is  where you  place additional network  addresses that
  82.                you may  have.  You must  have a separate AKA  statement for
  83.                each  additional address you  want to use.   You can have as
  84.                many of these statements as you like.
  85.  
  86.                Example:
  87.  
  88.                     AKA   89:480/124
  89.  
  90.  
  91.           ALIAS <alias>
  92.                By  default, JVArcServ only recognizes messages addressed to
  93.                "JVArcServ".    Using  the   ALIAS  command,  you  can  have
  94.                JVArcServ process  messages addressed  to other names.   You
  95.                can have as many ALIAS statements as you like.
  96.  
  97.                Example:
  98.  
  99.                     ALIAS ArcServ
  100.                     ALIAS JVArc
  101.  
  102.  
  103.           NETFILES <path>
  104.                This  is the path to your network file directory.  JVArcServ
  105.                will look in this directory  to find new file lists sent  in
  106.                from other systems.   This  line must appear  once and  only
  107.                once somewhere in the configuration file.
  108.  
  109.                Example:
  110.  
  111.                     NETFILES  e:\quickbbs\netfiles
  112.  
  113.  
  114.           NETMAIL <path>
  115.                This is the path to your  netmail directory.  This line must
  116.                appear  once and  only once  somewhere in  the configuration
  117.                file.
  118.  
  119.                Example:
  120.  
  121.                     NETMAIL  e:\quickbbs\netmail
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.           OUTPATH <path>
  130.                This  is the path to  your primary outbound  area.  Outbound
  131.                mail to zones other  than your primary one will be placed in
  132.                the same path  name with '.zzz' placed at the  end where zzz
  133.                is  the zone number.   This line  must appear  once and only
  134.                once somewhere in the configuration file.
  135.  
  136.                Example:
  137.  
  138.                     OUTPATH  e:\quickbbs\outbound
  139.  
  140.                In this  case, mail sent to  someone in zone 1  would be put
  141.                into the directory  'e:\quickbbs\outbound', while mail  sent
  142.                to  someone in  zone  89 would  be  put into  the  directory
  143.                'e:\quickbbs\outbound.059'.  (059 is hexadecimal for 89.)
  144.  
  145.  
  146.           LOG
  147.                This instructs JVArcServ  to keep a  log of all  happenings.
  148.                The  log will tell you  who has made  requests, what systems
  149.                have registered, and new  file lists that have come in.   By
  150.                default, the log is written to 'jvarcsrv.log' in the current
  151.                directory.
  152.  
  153.                Example:
  154.  
  155.                     LOG
  156.  
  157.  
  158.           LOGFILENAME <filename>
  159.                This  tells  JVArcServ to  use a  different filename  as the
  160.                logfile  instead of  the default  value.   This line  has no
  161.                effect  if LOG  does not  appear  in the  configuration file
  162.                somewhere as well.
  163.  
  164.                Example:
  165.  
  166.                     LOGFILENAME e:\quickbbs\logfile.jas
  167.  
  168.  
  169.           MOTD <filename>
  170.                Message  of the Day.  This optional command will include the
  171.                textfile  specified  as  <filename>  at  the  top  of  every
  172.                response  JVArcServ  sends  out.     This  only  applies  to
  173.                responses to  inquiries and not to  maintenance messages and
  174.                file request messages.
  175.  
  176.                Example:
  177.  
  178.                     MOTD news.txt
  179.  
  180.  
  181.           FILELISTS <path>
  182.                This is the  path to the  directory which  holds all of  the
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.                file  lists from all the registered systems.  This line must
  191.                appear  once and  only once  somewhere in  the configuration
  192.                file.
  193.  
  194.                Example:
  195.  
  196.                     FILELISTS e:\jvasfile
  197.  
  198.  
  199.           ZONE <num> <desc>
  200.                This is  where you tell  JVArcServ which zones  you support,
  201.                and what networks they are.  While you should have at  least
  202.                one of these statements, they are  optional.  JVArcServ uses
  203.                this  information  when  a  user  selects   the  "LISTZONES"
  204.                command.   You can have as  many of these statements  as you
  205.                wish.
  206.  
  207.                Example:
  208.  
  209.                     ZONE 1 FidoNet
  210.                     ZONE 89 IMEX
  211.  
  212.  
  213.           ORIGIN <string>
  214.                This  is the  line that  is included  on the  end  of return
  215.                messages to  users, known as an  origin line.  You  need not
  216.                include your address in <string> since it is tacked onto the
  217.                end of the origin line anyways.
  218.  
  219.                Example:
  220.  
  221.                     ORIGIN Gidget Information Systems, Toronto
  222.  
  223.  
  224.           MAILER <mailer>
  225.                This is used  to select  the type of  mailer that you  have.
  226.                Valid <mailer> are Binkley and Frontdoor.  This defines  how
  227.                file requests are made.  Using Binkley, the default, creates
  228.                a '.req' file and a '.flo' file.  Using FrontDoor  creates a
  229.                netmail message with the file request bit set.
  230.  
  231.                Example:
  232.  
  233.                     MAILER BINKLEY
  234.  
  235.  
  236.           NOFORCEPHONE
  237.                This  does not force the  phone number in  the incoming file
  238.                lists  to conform to a  predefined format.   By default, the
  239.                phone number  contained in new  file lists are  checked that
  240.